package com.liusy.serachengine.demo;

public interface BookSearch extends Search {

	/**
	 * 此方法用于指定或清除由此搜索器返回的有关结果集的限制。为了建立限制，type 和 opt_value 均必须提供且有效。为了清除限制，请为
	 * type 提供一个有效值，或为 opt_value 的值指定 null，或者不提供此值。
	 * 
	 * 此 API 当前支持以下限制类型：
	 * 
	 * a.search.Search.RESTRICT_TYPE - 当此限制类型指定为 type 值时，提供
	 * a.search.BookSearch.TYPE_FULL_VIEW_BOOKS 的 opt_value 将结果限于“完整查看书籍”。提供
	 * a.search.BookSearch.TYPE_ALL_BOOKS. 值允许搜索器返回所有图书。请注意，清除
	 * a.search.Search.RESTRICT_TYPE 限制时，这是默认且有效的操作。
	 * GSearchgoogle.search.BookSearch.USER_LIST - 当此限制类型指定为 type 值时，opt_value
	 * 值用于指定用户的库。查询将只限于在该库中存在的图书。提供值 null 会清除此限制，从而允许搜索查看所有库中的所有图书。请注意，这是默认操作。
	 * 
	 * @param type
	 *            - 提供了要建立的限制的类型： a.search.Search.RESTRICT_TYPE
	 *            a.search.BookSearch.USER_LIST
	 * @param opt_value
	 *            - 为指定的限制类型提供值。如果值为空，将清除指定的限制。否则，与 type
	 *            值相关的值必须有效，在这种情况下，会建立一个限制。请参见上述内容。
	 */
	public void setRestriction(String type, String opt_value);

}
